// RAP [rh] ICommandManager and related classes disabled
///*******************************************************************************
// * Copyright (c) 2000, 2005 IBM Corporation and others.
// * All rights reserved. This program and the accompanying materials
// * are made available under the terms of the Eclipse Public License v1.0
// * which accompanies this distribution, and is available at
// * http://www.eclipse.org/legal/epl-v10.html
// *
// * Contributors:
// * IBM Corporation - initial API and implementation
// *******************************************************************************/
//
//package org.eclipse.ui.commands;
//
//import java.util.Map;
//import java.util.Set;
//
////import org.eclipse.ui.keys.KeySequence;
//
///**
// * <p>
// * An instance of <code>ICommandManager</code> can be used to obtain instances
// * of <code>ICommand</code>, as well as manage whether or not those instances
// * are active or inactive, enabled or disabled.
// * </p>
// * <p>
// * This interface is not intended to be extended or implemented by clients.
// * </p>
// *
// * @since 3.0
// * @see org.eclipse.ui.commands.ICommand
// * @see org.eclipse.ui.commands.ICommandManagerListener
// * @see org.eclipse.core.commands.CommandManager
// * @deprecated Please use the "org.eclipse.core.commands" plug-in instead.
// * @noimplement This interface is not intended to be implemented by clients.
// */
//public interface ICommandManager {
//
// /**
// * Registers an instance of <code>ICommandManagerListener</code> to listen
// * for changes to attributes of this instance.
// *
// * @param commandManagerListener
// * the instance of <code>ICommandManagerListener</code> to
// * register. Must not be <code>null</code>. If an attempt is
// * made to register an instance of
// * <code>ICommandManagerListener</code> which is already
// * registered with this instance, no operation is performed.
// */
// void addCommandManagerListener(
// ICommandManagerListener commandManagerListener);
//
// /**
// * Returns the set of identifiers to active contexts.
// * <p>
// * Notification is sent to all registered listeners if this property
// * changes.
// * </p>
// *
// * @return the set of identifiers to active contexts. This set may be
// * empty, but is guaranteed not to be <code>null</code>. If this
// * set is not empty, it is guaranteed to only contain instances of
// * <code>String</code>.
// */
// Set getActiveContextIds();
//
// /**
// * Returns the active key configuration.
// * <p>
// * Notification is sent to all registered listeners if this property
// * changes.
// * </p>
// *
// * @return the active key configuration identifier. This set may be empty,
// * but it is guaranteed to not be <code>null</code>. If this set
// * is not empty, it is guaranteed to only contains instances of
// * <code>String</code>.
// */
// String getActiveKeyConfigurationId();
//
// /**
// * Returns the active locale. While this property tends to be simply the
// * result of {@link java.util.Locale#getDefault()}, it may also be changed
// * at runtime by different implementations of command manager.
// * <p>
// * Notification is sent to all registered listeners if this property
// * changes.
// * </p>
// *
// * @return the active locale. May be <code>null</code>.
// */
// String getActiveLocale();
//
// /**
// * Returns the active platform. While this property tends to be simply the
// * result of {@link org.eclipse.swt.SWT#getPlatform()}, it may also be
// * changed at runtime by different implementations of command manager.
// * <p>
// * Notification is sent to all registered listeners if this property
// * changes.
// * </p>
// *
// * @return the active platform. May be <code>null</code>.
// */
// String getActivePlatform();
//
// /**
// * Returns a handle to a category given an identifier.
// *
// * @param categoryId
// * an identifier. Must not be <code>null</code>
// * @return a handle to a category.
// */
// ICategory getCategory(String categoryId);
//
// /**
// * Returns a handle to a command given an identifier.
// *
// * @param commandId
// * an identifier. Must not be <code>null</code>
// * @return a handle to a command; never <code>null</code>.
// */
// ICommand getCommand(String commandId);
//
// /**
// * <p>
// * Returns the set of identifiers to defined categories.
// * </p>
// * <p>
// * Notification is sent to all registered listeners if this attribute
// * changes.
// * </p>
// *
// * @return the set of identifiers to defined categories. This set may be
// * empty, but is guaranteed not to be <code>null</code>. If this
// * set is not empty, it is guaranteed to only contain instances of
// * <code>String</code>.
// */
// Set getDefinedCategoryIds();
//
// /**
// * <p>
// * Returns the set of identifiers to defined commands.
// * </p>
// * <p>
// * Notification is sent to all registered listeners if this attribute
// * changes.
// * </p>
// *
// * @return the set of identifiers to defined commands. This set may be
// * empty, but is guaranteed not to be <code>null</code>. If this
// * set is not empty, it is guaranteed to only contain instances of
// * <code>String</code>.
// */
// Set getDefinedCommandIds();
//
// /**
// * <p>
// * Returns the set of identifiers to defined key configurations.
// * </p>
// * <p>
// * Notification is sent to all registered listeners if this attribute
// * changes.
// * </p>
// *
// * @return the set of identifiers to defined key configurations. This set
// * may be empty, but is guaranteed not to be <code>null</code>.
// * If this set is not empty, it is guaranteed to only contain
// * instances of <code>String</code>.
// */
// Set getDefinedKeyConfigurationIds();
//
// /**
// * Returns a handle to a key configuration given an identifier.
// *
// * @param keyConfigurationId
// * an identifier. Must not be <code>null</code>
// * @return a handle to a key configuration.
// */
// IKeyConfiguration getKeyConfiguration(String keyConfigurationId);
//
// /**
// * Finds all of the commands which have key bindings that start with the
// * given key sequence.
// *
// * @param keySequence
// * The prefix to look for; must not be <code>null</code>.
// * @return A map of all of the matching key sequences (
// * <code>KeySequence</code>) to command identifiers (
// * <code>String</code>). This map may be empty, but it is never
// * <code>null</code>.
// */
// Map getPartialMatches(KeySequence keySequence);
//
// /**
// * Finds the command which has the given key sequence as one of its key
// * bindings.
// *
// * @param keySequence
// * The key binding to look for; must not be <code>null</code>.
// * @return The command id for the matching command, if any;
// * <code>null</code> if none.
// */
// String getPerfectMatch(KeySequence keySequence);
//
// /**
// * Checks to see whether there are any commands which have key bindings that
// * start with the given key sequence.
// *
// * @param keySequence
// * The prefix to look for; must not be <code>null</code>.
// * @return <code>true</code> if at least one command has a key binding
// * that starts with <code>keySequence</code>;<code>false</code>
// * otherwise.
// */
// boolean isPartialMatch(KeySequence keySequence);
//
// /**
// * Checks to see if there is a command with the given key sequence as one of
// * its key bindings.
// *
// * @param keySequence
// * The key binding to look for; must not be <code>null</code>.
// * @return <code>true</code> if a command has a matching key binding;
// * <code>false</code> otherwise.
// */
// boolean isPerfectMatch(KeySequence keySequence);
//
// /**
// * Unregisters an instance of <code>ICommandManagerListener</code>
// * listening for changes to attributes of this instance.
// *
// * @param commandManagerListener
// * the instance of <code>ICommandManagerListener</code> to
// * unregister. Must not be <code>null</code>. If an attempt is
// * made to unregister an instance of
// * <code>ICommandManagerListener</code> which is not already
// * registered with this instance, no operation is performed.
// */
// void removeCommandManagerListener(
// ICommandManagerListener commandManagerListener);
//}